iT邦幫忙

2026 iThome 鐵人賽

DAY 12
0
Claude AI

文科生的 Claude Code 30 日實戰:從零到台股研究工作台系列 第 12

Day 12-它說完成,我怎麼知道真的完成?

  • 分享至 

  • xImage
  •  

今天遇到的問題

AI 說「程式已完成」,可能只是檔案寫好了。能不能執行、輸入錯誤時會不會給提示,還需要自己確認。

一個核心概念:從使用者入口驗收

程式內部測試有價值,但使用者是透過命令入口操作。今天的成功條件很小:能看到繁中說明,未知參數會報錯,兩種啟動方式一致。

實作:建立最小 package

依 docs/PROJECT-BRIEF.md 建立 Python package research_workbench。
今天只做 argparse CLI 的 --help 與 --version。
在 pyproject.toml 定義 research console script,
並提供 python -m research_workbench 的等價入口。
暫不加 init、scan 或任何資料庫/網路動作。
使用標準庫,說明各檔案職責並執行最小入口測試。

PowerShell:

.\.venv\Scripts\python.exe -m pip install -e .
.\.venv\Scripts\research.exe --help
.\.venv\Scripts\python.exe -m research_workbench --help
.\.venv\Scripts\research.exe --unknown
$LASTEXITCODE

第三個呼叫應回報未知參數,不能默默當成成功。

如果版本提供 /run、/verify,選擇本 CLI 作為目標,觀察它是否真的執行命令。沒有這些 skills 仍可照上面手動核對;原生 skill 實測項保持未通過或不適用。Skills 的執行與驗證能力

一個失敗案例

pytest 通過,但 research 找不到。檢查是否安裝到本專案 .venv,以及 pyproject.toml 的入口是否指向正確函式。不要把「能 import」當成「命令可使用」。

當日驗收

  • [ ] 兩種入口都顯示一致的 help。
  • [ ] 未知參數回傳非零退出碼。
  • [ ] 在新終端機仍能用明確 .venv 路徑執行。

實測後補:三段輸出、入口檔位置,以及 AI 的驗收是否遺漏任何一步。

下一天預告

明天把整理研究問題的流程,寫成自己的第一個 Skill。


上一篇
Day 11-Skill 不是外掛大補丸:先試手邊的能力
下一篇
Day 13-第一個自製 Skill:把研究問題問清楚
系列文
文科生的 Claude Code 30 日實戰:從零到台股研究工作台17
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言